﻿<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
	<title>Q+前端文档</title>
	<link rel="shortcut icon" type="image/x-icon" href="files/favicon.ico" />
	<link type="text/css" rel="stylesheet" href="qpstyle/css.css"/>
	<script type="text/javascript" src="qpscript/jquery.min.js"></script>
	<script type="text/javascript" src="qpscript/all.js"></script>
	<script type="text/javascript">
		(function(){
			var color ={
				c0: "transparent",
				c1: "#E9F4E9",//浅绿
				c2: "#0C7823",//深绿
				c3: "#ffffff",
				c4: "#000000",
				c5: "#FF5138",//橙色
				c6: "#E8E8E8",
				c7: "#FFE0E6",//桃红色
				c8: "#ff0000",
				c9: "#3300FF" //蓝色
			}
			var paramActity = function(obj,bgC,fontC){
				obj.find("span").eq(0).css("color",fontC);
			}
			var lightBg = function(obj,bgC,fontC){
				obj.css("background-color",bgC);
				obj.find("td").eq(0).css("color",fontC);
			}
			$(function(){
				$("table tr:even").css("background-color",color.c6);
				$("table tr").each(function(){
					$(this).find("td").eq(0).css("font-weight","bold");
				});
				$(".paramList li").hover(function(){
					paramActity($(this),color.c1,color.c5);
				},function(){
					paramActity($(this),color.c0,color.c4);
				});
				$("table tr").hover(function(){
					bgcolor = $(this).css("background-color");
					apiC = $(this).find("td").eq(0).css("color");
					lightBg($(this),color.c7,color.c9);
				},function(){
					lightBg($(this),bgcolor,apiC);
				})
			});
		})();
	</script>
</head>
<body>
	<iframe src="top.html" frameborder="0" width="100%" height="72" class="top-frame"></iframe>
	<table cellpadding="0" cellspacing="0" class="front-end-tit">
	 <tr>
		<th style="min-width: 188px;">API名称</th>
		<th style="min-width: 57px;">功能描述</th>
		<th style="min-width: 276px;">语法</th>
		<th style="min-width: 136px;">参数</th>
		<th style="min-width: 102px;">返回值</th>
		<th style="min-width: 129px;">说明</th>
	 </tr>
	</table>
	<table cellpadding="0" cellspacing="0" class="front-end-con">
	 <tr>
		<td>qplus.system.shareApp</td>
		<td>弹出分享应用框</td>
		<td>
<pre>qplus.system.shareApp({
	msg: string,
	title: string,
	pic: string,
	desc: string,
	param: string,
shareBtnText: string
})</pre>
		</td>
		<td style="width:200px;">
		<ul class="paramList">
			<li><span>msg</span>：分享时给好友的留言，最多<span class="cm">150</span>字节。</li>
			<li><span>title</span>：分享消息的标题，最多<span class="cm">36</span>字节。</li>
			<li><span>pic</span>：在分享消息中显示的应用图标的url地址，图片尺寸<span class="cm">80*60</span>。</li>
			<li><span>desc</span>：在分享消息中显示的对应用的描述，最多<span class="cm">120</span>字节。</li>
			<li><span>param</span>：自定义参数，最多<span class="cm">240</span>字节。</li>
			<li><span>shareBtnTest</span>：可以自定义分享按钮的文字，最多<span class="cm">12</span>字节。</li>
		</ul>
		</td>
		<td class="tc">无</td>
		<td style="width:150px;">title,pic,desc 三个参数用于收到Push消息时候在消息中心的展示，pic所指图片尺寸为60*80，param参数用于应用程序的自定义参数。应用程序通过注册app.pushParam事件，获得分享方发送param数据。</td>
	 </tr>
	 <tr>
		<td>qplus.system.getToken</td>
		<td>获取登录当前应用的OpenID、OpenKey</td>
		<td>
<pre>qplus.system.getToken("function");</pre>
		</td>
		<td>
		<ul class="paramList">
			<li><span>function</span>：回调函数，可以是代码段的字符串表示（与eval函数的参数相同），或者是匿名函数、函数名</li>
		</ul>
		</td>
		<td class="wb">json（openID，openKey）<br />
			openID: string,<br />
			openKey: string
		</td>
		<td></td>
	 </tr>
	 <tr>
		<td>qplus.system.getVersion</td>
		<td>获得当前Q+API的版本</td>
		<td>
<pre>qplus.system.getVersion("function");</pre>
		</td>
		<td>
		<ul class="paramList">
			<li><span>function</span>：回调函数，可以是代码段的字符串表示（与eval函数的参数相同），或者是匿名函数、函数名</li>
		</ul>
		</td>
		<td class="wb">json（version）<br />
			version: string,<br />
		</td>
		<td>可以用本方法来判断是否在Q+的运行环境中。</td>
	 </tr>
	 <tr>
		<td>qplus.system.runSettingCenter</td>
		<td>打开Q+客户端的系统设置窗口</td>
		<td>
<pre>qplus.system.runSystemCenter();
qplus.system.runSystemCenter({
	pageID: string
});</pre>
		</td>
		<td>
		<ul class="paramList">
			<li><span>pageID</span>：可选。用于打开指定的设置页面，合法ID有：</li>
			<li><span>config_page_general</span>：基本设置</li>
			<li><span>config_page_msg</span>：消息提醒</li>
			<li><span>config_page_bkg</span>：Q+背景</li>
		</ul>
		</td>
		<td class="wb">Boolean
		</td>
		<td></td>
	 </tr>
	 <tr>
		<td>qplus.system.runApp</td>
		<td>一键安装应用</td>
		<td>
<pre>qplus.system.runApp(
	{'appID' : '*******', 
	'autoInstall' : true}, 
	function(){});
});</pre>
		</td>
		<td>
		<ul class="paramList">
			<li><span>appID</span>：应用的appid</li>
		</ul>
		</td>
		<td class="wb">json{appID,result}<br />
			appID: string,
			result: '成功' || '失败'
		</td>
		<td>需要后台开通权限</td>
	 </tr>
	 <tr>
		<td>qplus.system.setWallpaper</td>
		<td>设置Q+桌面壁纸</td>
		<td>
<pre>qplus.system.setWallpaper(
	{url:string,type:string},
	function(json){}
);</pre>
		</td>
		<td>
		<ul class="paramList">
			<li><span>url</span>：图片地址，支持jpg，jpeg，png，bmp图片格式</li>
			<li><span>type</span>：壁纸绘制方式，可取值'filling', 'adapt' , 'stretch' , 'flat' , 'center'，其中'filling'为默认值</li>
		</ul>
		</td>
		<td class="wb">json{retCode}<br />
			retCode: 0 || 1 <br />
			0表示成功，1表示失败

		</td>
		<td>Q+ API 2.5版本及以上，仅供内容应用使用。</td>
	 </tr>
	 <tr>
		<td>qplus.user.getNick</td>
		<td>获得当前登录用户的QQ昵称</td>
		<td>
<pre>qplus.user.getNick("function");</pre>
		</td>
		<td>
		<ul class="paramList">
			<li><span>function</span>：回调函数，可以是代码段的字符串表示（与eval函数的参数相同），或者是匿名函数、函数名</li>
		</ul>
		</td>
		<td class="wb">json{nick}<br />
			nick: string 用户的QQ昵称
		</td>
		<td>用户授权才能调用。</td>
	 </tr>
	 <tr>
		<td>qplus.user.getHead</td>
		<td>获得当前登录用户QQ头像的url地址</td>
		<td>
<pre>qplus.user.getHead("function");</pre>
		</td>
		<td>
		<ul class="paramList">
			<li><span>function</span>：回调函数，可以是代码段的字符串表示（与eval函数的参数相同），或者是匿名函数、函数名</li>
		</ul>
		</td>
		<td class="wb">json{head}<br />
			head: string 用户QQ头像的url地址。
		</td>
		<td>用户授权才能调用。</td>
	 </tr>
	 <tr>
		<td>qplus.user.auth</td>
		<td>打开用户授权页面，用户授权后可以获得用户的openID，openKey及sig签名等信息。</td>
		<td>
<pre>qplus.user.auth(loginParam,"function");</pre>
		</td>
		<td>
		<ul class="paramList">
			<li><span>loginParam</span>：登录参数，通过应用后台调用OpenID SDK 中的getLoginParams方法获得。</li>
			<li><span>function</span>：回调函数，可以是代码段的字符串表示（与eval函数的参数相同），或者是匿名函数、函数名</li>
		</ul>
		</td>
		<td class="wb" style="width:100px;">json{auth,param}<br />
			auth: Boolean 授权是否成功 <br />
			param：string 包含授权后用户的openID,openKey 及sig签名等信息，格式为："app_lang=2052&app_nonce=pppppp&app_openid=xxxxxxxx&app_openkey=yyyyyy&app_ts=1234456789&sig=hhhhhhhhhhhhhh"
		</td>
		<td style="width:100px;">param参数：app_id：第三方应用的AppID。app_nonce：一次性随即字符串，必须保证同一个app_ts内唯一。
			app_lang：第三方应用的语言（2052：简体中文，1028：繁体中文，1033：英文）。app_userip:用户ip,
			app_ts:时间戳（自January 1,1970 00:00:00 GMT以来经过的秒数）。sig：URL参数签名。
			param由应用程序的后台服务器生成，前台页面从后台服务器获取。
		</td>
	 </tr>
	 <tr>
		<td>qplus.window.close</td>
		<td>关闭应用程序窗口</td>
		<td>
<pre>qplus.window.close();</pre>
		</td>
		<td>
			无
		</td>
		<td>	
			无
		</td>
		<td>
			关闭应用程序窗口前会触发window.close事件
		</td>
	 </tr>
	 <tr>
		<td>qplus.window.flashWindow</td>
		<td>是应用程序窗口闪烁。<em style="color:#ff0000;">目前还未实现</em></td>
		<td>
<pre>qplus.window.flashWindow();</pre>
		</td>
		<td>
			无
		</td>
		<td>	
			无
		</td>
		<td>
			该功能目前还未实现
		</td>
	 </tr>
	 <tr>
		<td>qplus.window.fullScreen</td>
		<td>应用程序窗口全屏显示。</td>
		<td>
<pre>qplus.window.fullScreen();</pre>
		</td>
		<td>
			无
		</td>
		<td>	
			无
		</td>
		<td>
			只有当窗口不在全屏状态是有效。全屏显示前会触发window.fullScreen事件。
		</td>
	 </tr>
	 <tr>
		<td>qplus.window.min</td>
		<td>最小化应用程序窗口。</td>
		<td>
<pre>qplus.window.min();</pre>
		</td>
		<td>
			无
		</td>
		<td>	
			无
		</td>
		<td>
			应用程序窗口最小化前会触发window.min事件。
		</td>
	 </tr>
	 <tr>
		<td>qplus.window.restore</td>
		<td>将全屏状态或最小化的窗口还原到原来的尺寸大小的位置。</td>
		<td>
<pre>qplus.window.restore();</pre>
		</td>
		<td>
			无
		</td>
		<td>	
			无
		</td>
		<td>
			当窗口在全屏状态时或最小化状态时有效。窗口还原前会触发window.restore事件。
		</td>
	 </tr>
	 <tr>
		<td>qplus.window.setCurrent</td>
		<td>激活应用程序窗口，并设置最靠前的窗口。</td>
		<td>
<pre>qplus.window.setCurrent();</pre>
		</td>
		<td>
			无
		</td>
		<td>	
			boolean 是否调用成功。
		</td>
		<td>
			执行本方法会触发window.setCurrent事件。
		</td>
	 </tr>
	 <tr>
		<td>qplus.window.setNotCurrent</td>
		<td>取消窗口的激活状态，并将窗口设置为非最靠前的窗口。</td>
		<td>
<pre>qplus.window.setNotCurrent();</pre>
		</td>
		<td>
			无
		</td>
		<td>	
			boolean 是否调用成功。
		</td>
		<td>
			执行本方法会触发window.setNotCurrent事件。
		</td>
	 </tr>
	 <tr>
		<td>qplus.window.setWinSize</td>
		<td>设置应用程序窗口的外框尺寸大小。</td>
		<td>
<pre>qplus.window.setWinSize({
	cx: num
	cy: num
});</pre>
		</td>
		<td>
			<ul class="paramList">
			<li><span>cx</span>：窗口宽度的像素值</li>
			<li><span>cy</span>：窗口高度的像素值</li>
		</ul>
		</td>
		<td>	
			boolean 是否设置成功。
		</td>
		<td style="width: 150px;">
			改变窗口大小会触发window.resize事件。
			注意：窗口尺寸不等于应用程序显示区域。应用程序显示区域等于窗口尺寸减去窗口的边框。
		</td>
	 </tr>
	 <tr>
		<td>qplus.window.setWinSize</td>
		<td>设置应用程序窗口的外框尺寸大小。</td>
		<td>
<pre>qplus.window.setWinSize({
	cx: num
	cy: num
});</pre>
		</td>
		<td>
			<ul class="paramList">
			<li><span>cx</span>：窗口宽度的像素值</li>
			<li><span>cy</span>：窗口高度的像素值</li>
		</ul>
		</td>
		<td>	
			boolean 是否设置成功。
		</td>
		<td style="width: 150px;">
			改变窗口大小会触发window.resize事件。
			注意：窗口尺寸不等于应用程序显示区域。应用程序显示区域等于窗口尺寸减去窗口的边框。
		</td>
	 </tr>
	 <tr>
		<td>qplus.window.setTitle</td>
		<td>设置应用程序窗口标题栏的文字。</td>
		<td>
<pre>qplus.window.setTitle({
	title: string
});</pre>
		</td>
		<td>
			<ul class="paramList">
			<li><span>title</span>：显示在应用程序窗口标题栏的文字。</li>
		</ul>
		</td>
		<td>	
			boolean 是否设置成功。
		</td>
		<td style="width: 150px;">
			改变窗口大小会触发window.resize事件。
			注意：窗口尺寸不等于应用程序显示区域。应用程序显示区域等于窗口尺寸减去窗口的边框。
		</td>
	 </tr>
	 <tr>
		<td>qplus.window.setPageSize</td>
		<td>设置应用程序窗口中应用程序显示区域的尺寸大小。</td>
		<td>
<pre>qplus.window.setPageSize({
	cx: num,
	cy: num
});</pre>
		</td>
		<td>
			<ul class="paramList">
			<li><span>cx</span>：应用程序显示区域宽度的像素值</li>
			<li><span>cy</span>：应用程序显示区域高度的像素值</li>
			</ul>
		</td>
		<td>	
			boolean 是否设置成功。
		</td>
		<td style="width: 150px;">
			注意：窗口尺寸不等于应用程序显示区域。应用程序显示区域等于窗口尺寸减去窗口的边框。
			设置应用程序显示区域会改变窗口大小，并触发window.resize事件。
		</td>
	 </tr>
	 <tr>
		<td>qplus.window.setWinPos</td>
		<td>设置应用程序窗口左上角相对屏幕的位置。</td>
		<td>
<pre>qplus.window.setWinPos({
	x: num,
	y: num
});</pre>
		</td>
		<td>
			<ul class="paramList">
			<li><span>x</span>：应用程序窗口左上角相对屏幕的X轴坐标</li>
			<li><span>y</span>：应用程序窗口左上角相对屏幕的Y轴坐标</li>
			</ul>
		</td>
		<td>	
			boolean 是否设置成功。
		</td>
		<td>
		</td>
	 </tr>
	 <tr>
		<td>qplus.payment.trade</td>
		<td>打开支付页面。</td>
		<td>
<pre>qplus.payment.trade({ 
	  platform: "unipay", 
	  sandbox:    1， 
	  url_params: data.url_params 
});</pre>
		</td>
		<td>
			<ul class="paramList">
			<li><span>platform</span>：代表支付平台，"unipay"表示云支付，Q币支付</li>
			<li><span>sandbox</span>：0表示现网环境，1表示沙箱环境</li>
			<li><span>url_params</span>：申请Token时后台返回的url_params的参数</li>
			</ul>
		</td>
		<td>	
			当用户支付成功后，腾讯的云支付服务器会调用APP注册的发货接口进行发货通知。
		</td>
		<td>
		</td>
	 </tr>
	 <tr>
		<td>payment.stateChange</td>
		<td>监听支付状态变化（包括支付成功和支付失败以及重新支付和关闭支
付窗口）</td>
		<td>
<pre>qplus.on("payment.stateChange",function(){}); </pre>
		</td>
		<td>
			
		</td>
		<td>	
			json{state} 
			state: retry或change；
			如果是“retry” 第三方应用需要重新获取token，并再次发起交易请求。
			如果是“change” 第三方应用需要去后台查询token的状态
		</td>
		<td>
			
		</td>
	 </tr>
	 <tr>
		<td>system.exit</td>
		<td>用户退出Q+平台时的通知事件。</td>
		<td>
<pre>qplus.on("system.exit",function(){});</pre>
		</td>
		<td>
			
		</td>
		<td>	
			无
		</td>
		<td>
			用户退出Q+平台时触发
		</td>
	 </tr>
	 <tr>
		<td>system.loginSuccess</td>
		<td>用户成功登陆Q+发出的通知。</td>
		<td>
<pre>qplus.on("system.loginSuccess",function(){});</pre>
		</td>
		<td>
			
		</td>
		<td>	
			无
		</td>
		<td>
			打开应用程序后，网络终端，网络连接恢复后，Q+重新登陆可以在应用程序中触发本事件。
		</td>
	 </tr>
	 <tr>
		<td>system.Disconnect</td>
		<td>网络发生中断的通知事件。</td>
		<td>
<pre>qplus.on("system.Disconnect",function(){});</pre>
		</td>
		<td>
			
		</td>
		<td>	
			无
		</td>
		<td>
		</td>
	 </tr>
	 <tr>
		<td>system.netConnect</td>
		<td>恢复网络连接时的通知事件。</td>
		<td>
<pre>qplus.on("system.netConnect",function(){});</pre>
		</td>
		<td>
			
		</td>
		<td>	
			无
		</td>
		<td>
		</td>
	 </tr>
	 <tr>
		<td>system.qplusID</td>
		<td>Q+平台获得qplusID后的通知事件。</td>
		<td>
<pre>qplus.on("system.qplusID",function(){});</pre>
		</td>
		<td>
			
		</td>
		<td>	
			json{qplusID} <br />
				qplusID: string
		</td>
		<td>
			应用程序启动时，会触发一次此事件。
		</td>
	 </tr>
	 <tr>
		<td>system.shareApp</td>
		<td>Q+平台获得分享应用程序后的通知事件。</td>
		<td>
<pre>qplus.on("system.shareApp",function(){});</pre>
		</td>
		<td>
			
		</td>
		<td>	
			json{shareRet} <br />
				shareRet: bool <br />
				true 表示用户在分享窗口中进行了分享操作。
				false 表示用户在关闭了分析窗口，没有进行分享操作。
		</td>
		<td>
			用户分享应用程序后，会触发一次此事件。
		</td>
	 </tr>
	 <tr>
		<td>window.close</td>
		<td>应用程序窗口关闭时的通知事件。</td>
		<td>
<pre>qplus.on("window.close",function(){});</pre>
		</td>
		<td>
			
		</td>
		<td>	
			无
		</td>
		<td>
			应用程序窗口关闭前触发。
		</td>
	 </tr>
	 <tr>
		<td>window.fullScreen</td>
		<td>应用程序窗口全屏时的通知事件。</td>
		<td>
<pre>qplus.on("window.fullScreen",function(){});</pre>
		</td>
		<td>
			
		</td>
		<td>	
			无
		</td>
		<td>
		</td>
	 </tr>
	 <tr>
		<td>window.min</td>
		<td>应用程序窗口最小化时的通知事件。</td>
		<td>
<pre>qplus.on("window.min",function(){});</pre>
		</td>
		<td>
			
		</td>
		<td>	
			无
		</td>
		<td>
		</td>
	 </tr>
	 <tr>
		<td>window.resize</td>
		<td>应用程序窗口发生改变时的通知事件。</td>
		<td>
<pre>qplus.on("window.resize",function(){});</pre>
		</td>
		<td>
			
		</td>
		<td>	
			json{width,height} <br />
				width: num <br />
				height: num 
		</td>
		<td>
			应用程序窗口大小改变时会触发此事件。
		</td>
	 </tr>
	 <tr>
		<td>window.restore</td>
		<td>应用程序窗口从全屏或最小化还原到原来的大小和位置时的通知事件。</td>
		<td>
<pre>qplus.on("window.restore",function(){});</pre>
		</td>
		<td>
			
		</td>
		<td>	
			无
		</td>
		<td>
		</td>
	 </tr>
	 <tr>
		<td>window.setCurrent</td>
		<td>当应用程序窗口获得焦点时的通知事件。</td>
		<td>
<pre>qplus.on("window.setCurrent",function(){});</pre>
		</td>
		<td>
			
		</td>
		<td>	
			无
		</td>
		<td>
		</td>
	 </tr>
	 <tr>
		<td>window.setNotCurrent</td>
		<td>当应用程序窗口失去焦点时的通知事件。</td>
		<td>
<pre>qplus.on("window.setNotCurrent",function(){});</pre>
		</td>
		<td>
			
		</td>
		<td>	
			无
		</td>
		<td>
		</td>
	 </tr>
	 <tr>
		<td>app.pushParam</td>
		<td>应用程序收到推送消息时的通知事件。<span style="color:#ff0000;">(消息中心查看)</span></td>
		<td>
<pre>qplus.on("app.pushParam",function(){});</pre>
		</td>
		<td>
			
		</td>
		<td>	
			json{pushParam} <br />
				pushParam: string
		</td>
		<td style="width:150px;">
			此事件用于接收应用程序通过调用system.appShare方法分享时发送的自定义数据。
			pushParam对应system.appShare中的param参数。应用程序首次启动，第一次注册
			app.pushParam，可立即触发事件。
		</td>
	 </tr>
	</table>
	<iframe src="footer.html" frameborder="0" class="footer-frame"></iframe>
	<script type="text/javascript">
		G.goTop();
	</script>
</body>
</html>